package com.example.authsystem.repository;

import com.example.authsystem.model.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

import java.util.Optional;

/**
 * 用户数据访问层接口
 * 继承JpaRepository，提供用户实体的CRUD操作和自定义查询方法
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    /**
     * 根据用户名查找用户
     * 用于用户登录验证和获取用户信息
     * 
     * @param username 用户名
     * @return 包含用户对象的Optional，如果不存在则为empty
     */
    Optional<User> findByUsername(String username);

    /**
     * 根据邮箱查找用户
     * 用于邮箱验证和找回密码功能
     * 
     * @param email 用户邮箱
     * @return 包含用户对象的Optional，如果不存在则为empty
     */
    Optional<User> findByEmail(String email);

    /**
     * 检查用户名是否已存在
     * 用于用户注册时的唯一性验证
     * 
     * @param username 要检查的用户名
     * @return 如果用户名已存在返回true，否则返回false
     */
    boolean existsByUsername(String username);

    /**
     * 检查邮箱是否已存在
     * 用于用户注册时的唯一性验证
     * 
     * @param email 要检查的邮箱
     * @return 如果邮箱已存在返回true，否则返回false
     */
    boolean existsByEmail(String email);
}